home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2004 April / Gamestar_61_2004-04_dvdb.iso / DVDStar / Editace / hltp.exe / {app} / Source Code / Zoners Half-Life Tools / Readme.txt < prev    next >
Text File  |  2001-04-25  |  5KB  |  128 lines
  1. ==========
  2. Background
  3. ==========
  4.  
  5.     ZHLT is developed on two main systems: A Dual Processor (p3-700) 
  6. Windows 2000 machine, and a Dual Processor (p3-500) Linux machine running Debian.
  7. The released versions for windows are compiled with the Intel C/C++ 4.5 compiler
  8. and GNU make.  The visual studio projects, while included, aren't used and have
  9. a tendency to not always have all the newborn files in a release added to their
  10. projects correctly :)
  11.  
  12.  
  13. ===============
  14. Windows Systems
  15. ===============
  16. Requirements:
  17.  (x)   Microsoft Visual C++ 6
  18.  
  19. Recommended:
  20.  (x)   Intel C/C++ Compiler 4.0 or 4.5
  21.  (x)   GNU make, on Windows, Cygwin can provide a working GNU make, available
  22.     at http://sourceware.cygnus.com/cygwin/
  23.  (x)   CommonC++ 1.4.2+ libraries (for compiling netvis) Available at 
  24.     http://sourceforge.net/project/?group_id=1523
  25.  
  26.     The project can either be built with GNU make (including on Windows 
  27. platforms) or directly with Microsoft Visual Studio 6 (just open zhlt.dsw)
  28. When using GNU make, choosing between MSVC or ICL requires editing make.ctl
  29. and changing the line COMPILER:=intel with COMPILER:=msvc
  30.  
  31.  
  32. ==================
  33. Unix/Posix Systems
  34. ==================
  35. Requirements:
  36.  (x)   g++
  37.  (x)   GNU make
  38.  (x)   pthread compatibility
  39.  
  40. Recommended:
  41.  (x)   CommonC++ 1.4.2+ libraries (for compiling netvis) Available at 
  42.     http://sourceforge.net/project/?group_id=1523
  43.  
  44. ATTENTION: Currently the posix tree of CommonC++ will compile and link with ZHLT 2.5.x
  45. but the socket code mysteriously seems to not be working.  This should be addressed in
  46. an upcoming point release in either ZHLT or CommonC++ when the problem is found and fixed.
  47.  
  48.     The unix compile relies on several things, which probably needs friendlier
  49. cross-platform handling.  The big requirements are requiring <asm/atomic.h> and
  50. <pthread.h>, GNU make, and gcc.
  51.     configure MUST be run.  The 'makefile' that exists while looking innocent enough
  52. has a few things missing and is setup for GNU make on windows to work out of the box.
  53. configure has to run to populate some variables from makefile.in and generate a 
  54. custom makefile for the machine in question.
  55.     The only known issue with compiling Netvis & CommonC++ was that PTHREAD_HAVE_RWLOCK
  56. was defined through CommonC++'s and in their config.h and my Linux/Debian system did not like
  57. that define enabled, so I had to edit config.h and remove the #define PTHREAD_HAVE_RWLOCK before
  58. building CommonC++ and installing it.
  59.  
  60.  
  61. ******************************
  62. *** Linux: Debian & Redhat ***
  63. ******************************
  64.     Should work with no changes.  Don't know about the other flavors.
  65.  
  66. ***************
  67. *** FreeBSD ***
  68. ***************
  69.     I dont have a FreeBSD system so this information comes 2nd hand from a user:
  70. Linux emulation needed (linux_base_6.1.tar.gz or newer?)
  71. Requires fbsd4.1 stable to work
  72. Had to edit make.os and replace -lpthread with -pthread
  73.     
  74.  
  75.  
  76. =========
  77. Misc Info
  78. =========
  79. ****************
  80. *** make.ctl *** 
  81. ****************
  82. The file make.ctl controls options in the make process
  83. MODE   : sets the default mode of compilation.  valid choices are
  84.          release, debug, super_debug (runtime heap checking), and 
  85.          release_w_symbols (meaningless on unix)
  86. MAPS   : On Win32 systems, controls whether or not .map files are
  87.          generated on link.
  88.  
  89.  
  90. *************************
  91. *** WAD files on unix ***
  92. *************************
  93.     Create a mirror of your Half-life directory somewhere, but only 
  94. include .wad files.  Make sure the filenames match up as it will become 
  95. case sensitive.  Next, create an environment variable called WADROOT and
  96. set it to this directory (with no trailing slash).
  97.  
  98. Example:
  99. WADROOT=/home/mcp/wads
  100.  
  101. mcp@oven:~$ ls -alR wads
  102. wads:
  103. total 28
  104. drwsrwsr-x    7 mcp      mcpadmin     4096 Aug  2 21:23 .
  105. drwxr-sr-x   14 mcp      mcp          4096 Oct  8 00:13 ..
  106. drwsrwsr-x    2 mcp      mcpadmin     4096 Jul 19 14:54 gearbox
  107. drwsrwsr-x    2 mcp      mcpadmin     4096 Jul 19 14:38 valve
  108.  
  109. wads/gearbox:
  110. total 10364
  111. drwsrwsr-x    2 mcp      mcpadmin     4096 Jul 19 14:54 .
  112. drwsrwsr-x    7 mcp      mcpadmin     4096 Aug  2 21:23 ..
  113. -rw-rw-r--    1 mcp      mcpadmin  1047952 Jul 13 00:56 decals.wad
  114. -rw-rw-r--    1 mcp      mcpadmin  4085336 Jul 17 18:18 op4ctf.wad
  115. -rw-rw-r--    1 mcp      mcpadmin  5308820 Jul 13 00:56 opfor.wad
  116.  
  117. wads/valve:
  118. total 45272
  119. drwsrwsr-x    2 mcp      mcpadmin     4096 Jul 19 14:38 .
  120. drwsrwsr-x    7 mcp      mcpadmin     4096 Aug  2 21:23 ..
  121. -rw-rw-r--    1 mcp      mcpadmin   924840 Jul 13 00:57 decals.wad
  122. -rw-rw-r--    1 mcp      mcpadmin 37914096 Jul 13 00:57 halflife.wad
  123. -rw-rw-r--    1 mcp      mcpadmin   475820 Jul 13 00:57 liquids.wad
  124. -rw-rw-r--    1 mcp      mcpadmin  6514528 Jul 13 00:57 xeno.wad
  125. -rw-rw-r--    1 mcp      mcpadmin     2380 Jul 13 00:57 zhlt.wad
  126.  
  127.  
  128.